This directory contains examples demonstrating the use of the Oracle XML SQL
Utility (XSU).


sql files
----------

samps.sql - SQL script to set up the schema used by some of the samples

bindSQLVariables.sql - Shows use of DBMS_XMLQuery with bind variables

changeElementName.sql - Shows use of DBMS_XMLQuery where ROW and ROWSET tags
                      are changed from their defaults

createObjRelSchema.sql - Setup script for use with createObjRelSchema2.sql

createObjRelSchema2.sql - Shows create of OR Schema which can show use of
                        XSU with object types

createRelSchema.sql - Creates example relational table

deleteEmployeeByKey.sql - Shows deletion using key columns, for use with
                        testDeleteKey.sql

deleteEmployeeByRow.sql - Shows deletion without key columns, for use with
                        testDeleteRow.sql

insProc.sql - Shows simple insertion example

insertClob.sql - Populates clob column with XML data, for use with
               insert/update/delete examples on the EMPLOYEES table

insertClob2.sql - Populates clob column with XML data, for use with
               insert/update/delete examples on the EMPLOYEES table

insertClob3.sql - Populates clob column with XML data, for use with
               insert/update/delete examples on the EMPLOYEES table

insertClob4.sql - Populates clob column with XML data, for use with
               insert/update/delete examples on the EMPLOYEES table

insertEmployee.sql - Shows simple insert test on EMPLOYEES table

insertEmployee2.sql - Shows simple insert test on EMPLOYEES table

mapColumnToAtt.sql - Shows SQL query where a column would be mapped to an
                   attribute with XSU

paginateResults.sql - An example with DBMS_XMLQuery with paginated results

printClobOut.sql - Shows creation of a procedure used to print out results
                 in other examples

raiseException.sql - Shows exception handling with the XSU

setup_xmltype.sql - Sets up table with xmltype data

simpleQuery.sql - Simple DBMS_XMLQuery example

testDML.sql - This package shows how to reuse one context handle for multiple
            DML statements

testDeleteKey.sql - Creates procedure for use with deleteEmployeeByKey.sql

testDeleteRow.sql - Creates procedure for use with deleteEmployeeByRow.sql

testInsert.sql - Creates procedure for use with testInsert.java

testRef.sql - Setup script for use with refCurTest.java

testUpdateKey.sql - Shows use of key columns with update in DBMS_XMLSave

testUpdateSubset.sql - Shows update example when only updating certain columns

updateEmployee.sql - Shows simple update of EMPLOYEES table

updateEmployee2.sql - Shows simple update of EMPLOYEES table


xml files
----------

sampdoc.xml - sample xml document used in samples that putXML

customer.xml - Shows sample xml document which would be created with XSU on
             schema created in createObjRelSchema2.sql

new_emp.xml - XML file containing data to be used with DML examples on
            EMPLOYEES table

new_emp2.xml - XML file containing data to be used with DML examples on
             EMPLOYEES table

upd_emp.xml - XML file containing data to be used with DML examples on
            EMPLOYEES table

upd_emp2.xml - XML file containing data to be used with DML examples on
            EMPLOYEES table


CLASSES
---------

samp1.java - simple example on using Oracle XMLSQL API to get XML doc 
           given a SQL query
		
samp2.java - very similar to samp1 except samp2 demonstrates the usage of
           many customizations the user can use to shape the generated
           XML document

samp10.java - simple example of using the OracleXMLSave class to insert data
            from an XML document file into the database

domTest.java - Example where result is retreived from XSU as a DOM

noRowsTest.java - Shows XSU behavior when a query returns no rows

pageTest.java - Use of XSU with a scrollable result set to paginate results

paginateResults.java - Similar to previous, this example leaves the result set
                     open

refCurTest.java - Shows generation of XML from query containing a cursor

testDeleteKey.java - Shows usage of key columns with deletion

testDeleteRow.java - Shows usage of delete without use of key columns

testException.java - Shows exception handling with XSU in Java

testInsert.java - Shows simple insertion of data into tables using Java XSU

testInsertSubset.java - Shows insertion using update column list

testUpdate.java - Shows use of XSU to update relational tables

testUpdateList.java - Shows use of XSU to update relational tables with use of
                    update column list

testXMLSQL.java - Shows generation of XML as a string